# Установка и настройка

После того, как вы скачали плагин EasyPayments себе на компьютер, его необходимо установить на ваш сервер.

{% content-ref url="/pages/0sRtSu28ZjLhnqdzWSHN" %}
[Скачивание](/download.md)
{% endcontent-ref %}

### Установка

Перейдите в папку `/plugins` вашего сервера, загрузите `.jar`-файл и перезагрузите сервер.

После успешного запуска сервера должна появиться папка `/plugins/EasyPayments` с конфигурационным файлом `config.yml`.&#x20;

{% hint style="info" %}
Если после первичной установки вы обнаружили в консоли игрового сервера сообщение красного цвета: <mark style="color:red;">**`[EasyPayments] Please, specify your unique shop key in the config.yml`**</mark>, — это нормально.
{% endhint %}

### Настройка

#### Подготовка

Перед настройкой плагина проверьте, что он запущен и работает. Для этого отправьте на сервер команду:

```
/plugins
```

В списке всех установленных на вашем сервере плагинов найдите `EasyPayments`. Если его нет или подсвечивается красным, то плагин не был установлен корректно. Чтобы решить проблему, попробуйте повторить процедуру [установки](#ustanovka) или обратитесь в [техническую поддержку](https://vk.me/easydonate).

#### Интерактивная настройка

Интерактивная настройка — это настройка плагина непосредственно из игрового сервера, без необходимости редактирования конфигурационного файла `config.yml`.

{% hint style="info" %}
Интерактивную настройку может запустить только оператор или игрок с правами *`easypayments.command.setup`*. Подробнее о правах можно ознакомиться [здесь](/commands.md).
{% endhint %}

В консоли сервера запустите режим быстрой настройки, указав следующую команду:

```
/ep setup
```

Результатом выполнения команды будет следующее сообщение:

![Режим интерактивной настройки. Установка ключа магазина.](/files/3hcfMZ58CIHPSzAIsUtr)

Укажите в чате ключ вашего магазина. Он расположен в настройках магазина.

![Ключ магазина.](/files/gn2ZRSyIcAnirgfz7q9Z)

{% hint style="info" %}
Ключ магазина состоит из 32 случайных символов. Не путайте ключ магазина и идентификатор магазина.
{% endhint %}

После того, как вы указали ключ магазина, плагин попросит ввести в чате идентификатор (ID) вашего сервера. Найти его можно в настройках магазина, во вкладке «Серверы», — укажите его в чате.

![Идентификатор сервера.](/files/yWaZAMRqFPaNIdwRZOjb)

Если настройка завершена успешно, плагин отправит в чат результаты изменений. Если что-то в процессе пойдет не так, в чате появится сообщение с рекомендациями по исправлению ошибок.

![Сообщение об успешной настройке плагина.](/files/TPSLQeXRRYoPohLbGC40)

#### Редактирование конфига вручную

Для того чтобы правильно настроить выдачу товаров на сервере, откройте конфигурационный файл `/plugins/EasyPayments/config.yml`. Здесь необходимо указать два обязательных параметра:

1. **`key`** — ключ вашего магазина. Он состоит из 32 случайных символов, и найти его можно в настройках магазина.
2. **`server-id`** — идентификатор (ID) вашего сервера. Найти его можно в настройках магазина, во вкладке «Серверы».

{% hint style="warning" %}
Не путайте ключ магазина и идентификатор магазина.
{% endhint %}

Конечный конфиг должен выглядеть примерно следующим образом:

![Пример настроенного конфигурационного файла.](/files/AXzEwn4elr2WFs74FfPA)

После того, как вы указали оба параметра, перезапустите плагин командой:

```
/ep reload
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://easypayments.easydonate.ru/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
